home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2002 November
/
SGI Freeware 2002 November - Disc 2.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
catman
/
u_man
/
cat1
/
sendfax.Z
/
sendfax
Wrap
Text File
|
2002-07-08
|
36KB
|
708 lines
SENDFAX(1) SENDFAX(1)
NNAAMMEE
sendfax - submit a facsimile job for transmission
SSYYNNOOPPSSIISS
sseennddffaaxx [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s... ]
DDEESSCCRRIIPPTTIIOONN
_s_e_n_d_f_a_x submits one or more facsimile transmission
requests to a _H_y_l_a_F_A_X facsimile server. Requests are nor
mally processed immediately, although they may also be
queued for transmission at a later time using a syntax
identical to the _a_t(1) command. For each job that is
queued, _s_e_n_d_f_a_x prints a _j_o_b _i_d_e_n_t_i_f_i_e_r and a _j_o_b _g_r_o_u_p
_i_d_e_n_t_i_f_i_e_r on the standard output. A job identifier is
the token by which jobs are identified within _H_y_l_a_F_A_X; job
group identifiers are used to reference a set of jobs that
have been submitted at the same time. Job and job group
identifiers can be supplied to the _f_a_x_r_m(1) command to
remove the jobs or to the _f_a_x_a_l_t_e_r(1) command to alter job
parameters.
Facsimile are made from the concatenation of a cover page
(see below) and one or more files specified on the command
line. If no files are supplied on the command line, _s_e_n_d_
_f_a_x will read data from the standard input unless polling
is requested. Cover pages are distinguished for the pur
pose of generating ``_c_o_n_t_i_n_u_a_t_i_o_n _c_o_v_e_r _p_a_g_e_s'' on the
server; these are makeup cover pages that are automati
cally generated if a job fails after sending the original
user-specified cover page.
_s_e_n_d_f_a_x passes POSTSCRIPT and TIFF documents directly
through to the fax server for transmission, and attempts
to convert other file formats to either POSTSCRIPT or
TIFF. In normal operation _s_e_n_d_f_a_x automatically converts
ASCII-text, _t_r_o_f_f(1) output, Portable Document Format
(PDF), and Silicon Graphics format images for transmis
sion. Support for other file formats can be easily added
through an extensible file typing and conversion facility;
see _t_y_p_e_r_u_l_e_s(${MANNUM4_5}). Note that since TIFF Class F
documents are processed directly it is simple to forward a
received facsimile.
By default _s_e_n_d_f_a_x will generate a cover page for each
facsimile that is to be transmitted. This cover page is
created by the ancillary _f_a_x_c_o_v_e_r(1) program using infor
mation deduced by _s_e_n_d_f_a_x and by information supplied on
the command line. Automatic cover page generation may be
suppressed with the --nn option.
In addition to sending documents, _s_e_n_d_f_a_x can be used to
poll a remote facsimile machine to retrieve waiting docu
ments. If the --pp option is specified, a polling request
will be submitted to each destination. If a poll request
is made in conjunction with the transmission of documents,
the poll request will take place after the documents are
transmitted. Documents retrieved by polling are returned
to the requestor by electronic mail and may be viewed with
a suitable viewer program.
One or more destinations must be specified on the command
line using the --dd option. A destination is the dialing
string to use to contact the remote fax machine. Phone
numbers may include non-alphanumeric characters for read
ability--only alphanumerics and ``+'' (for denoting a
country code) are significant in placing a call. Alpha
betic characters are automatically mapped to their numeric
key equivalents: ``abcABC'' to ``2'', ``defDEF'' to ``3'',
etc. Dialing prefixes, such as ``1'' and ``011'' (for
long distance calling in the United States) need not be
included if an unambigous number is specified. Examples
of unambiguous phone numbers are:
+31.77.594.131 _t_o _c_a_l_l _t_h_e _N_e_t_h_e_r_l_a_n_d_s
+14159657824 _t_o _c_a_l_l _C_a_l_i_f_o_r_n_i_a
9657824 _t_o _m_a_k_e _a _l_o_c_a_l _c_a_l_l
1-215-356-1666 _t_o _c_a_l_l _P_e_n_n_s_y_l_v_a_n_i_a _f_r_o_m _w_i_t_h_i_n _t_h_e _U_S
Non-numeric strings, such as ``*70'' (to defeat call wait
ing), may be included in the destination phone number.
Whether or not they are stripped from the string used to
dial the destination fax machine is dependent on the dial
string rules configured for use on the server; c.f.
_h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MANNUM4_5}) and _d_i_a_l_r_u_l_e_s(${MANNUM4_5}).
A destination may also be specified as _u_s_e_r_@_f_a_x_-_n_u_m_b_e_r.
In this case the _u_s_e_r string will be passed to _f_a_x_c_o_v_e_r as
the identity of the recipient. Note that multi-word names
must be enclosed in quote marks; for example, ``Sam Lef
fler@+1.415.555.1212''.
The order of options on the command line is significant.
Each fax to be transmitted is assigned the current value
of parameters specified on the command line; e.g. whether
or not to generate a cover page. This means that options
that specify parameters for a particular destination must
precede the dialstring specified with the --dd option. For
example,
sendfax -n -d 5551212 /etc/passwd
submits a fax to 5551212 that has no cover page while
sendfax -d 5551212 -n /etc/passwd
submits the same fax but with the default cover page han
dling. Note also that parameter values persist across --dd
options so the following
sendfax -n -d 5551212 -d 5551313 /etc/network
submits two facsimile, both of which have no cover page.
OOPPTTIIOONNSS
--11 Transmit facsimile documents using 1-D MR com
pression. By default _H_y_l_a_F_A_X will use the
optimal compression scheme supported by the
transmitting modem and receiving facsimile
device.
--22 Transmit facsimile documents using 2-D MR com
pression, if possible. By default _H_y_l_a_F_A_X
will use the optimal compression scheme sup
ported by the transmitting modem and receiving
facsimile device.
--aa _t_i_m_e Schedule transmission up to one year in
advance at the indicated _t_i_m_e. _T_i_m_e is speci
fied in the format: ``[HH:MM [AM|PM]|now] [+ N
_p_e_r_i_o_d | _m_o_n_t_h DD | _d_a_y_o_f_w_e_e_k ] where _m_o_n_t_h
can be Jan(uary), Feb(ruary), Mar(ch),
Apr(il), May, Jun(e), Jul(y), Aug(ust),
Sep(tember), Oct(ober), Nov(ember), or
Dec(ember); _p_e_r_i_o_d can be minute(s), hour(s),
day(s), week(s), or month(s); _d_a_y_o_f_w_e_e_k can be
Mon(day), Tue(sday), Wed(nesday), Thu(rsday),
Fri(day), Sat(urday), Sun(day); e.g. ``now +
30 minutes to schedule transmission 30 min
utes in the future. Trailing information in
the _t_i_m_e field (such as YYYY) is ignored. By
default, _s_e_n_d_f_a_x schedules facsimile for imme
diate delivery. Time should be given in the
user's local time.
--bb _s_p_e_e_d Transmit facsimile documents using a sig
nalling rate that is constrained to be at
least _s_p_e_e_d bits/second. If the specified
speed is greater than the transmitting modem
or receiver is capable of, it is reduced to
the highest possible speed both devices sup
port. If a negotiated signalling rate greater
than or equal to _s_p_e_e_d cannot be negotiated
then the job is aborted. Possible speeds are:
2400, 4800, 7200, 9600, 12000, and 14400. By
default _H_y_l_a_F_A_X will use the fastest possible
rate supported by the transmitting modem and
receiving facsimile device.
--BB _s_p_e_e_d Try to transmit facsimile documents using the
desired signalling rate. Possible speeds are:
2400, 4800, 7200, 9600, 12000, and 14400. If
the specified speed is greater than the trans
mitting modem or receiver is capable of, it is
reduced to the highest possible speed both
devices support. By default _H_y_l_a_F_A_X will use
the fastest possible rate supported by the
transmitting modem and receiving facsimile
device (unless restricted by other server con
figuration); this option can be used to reduce
the speed. Note that international calls are
frequently more reliable when transmissions
are restricted to 9600 bits/second.
--cc _c_o_m_m_e_n_t_s Pass _c_o_m_m_e_n_t_s to the _f_a_x_c_o_v_e_r(1) program for
inclusion in the comments field of any gener
ated cover page.
--CC _f_i_l_e Pass _f_i_l_e to the _f_a_x_c_o_v_e_r(1) program for use
as the cover page template.
--DD Enable notification by electronic mail when
the facsimile has been delivered. By default
_H_y_l_a_F_A_X will notify the submitter only if
there is a problem with a job.
--dd _d_e_s_t_i_n_a_t_i_o_n
Create a job to transmit the supplied docu
ments to a facsimile machine at the indicated
_d_e_s_t_i_n_a_t_i_o_n. If the _d_e_s_t_i_n_a_t_i_o_n is of the
form ``_u_s_e_r@_p_h_o_n_e_-_n_u_m_b_e_r'' then any cover page
will show _u_s_e_r as the intended receipient.
--EE Disable use of the Error Correction Mode (ECM)
when transmitting page data. By default
_H_y_l_a_F_A_X will attempt to use ECM when both the
trasmitting modem and receiving device support
it. Note that international calls are some
times faster when ECM is disabled. Beware
also that some modems and/or facsimile devices
do not properly implement ECM causing trans
mission failures.
--ff _f_r_o_m Use _f_r_o_m as the identity of the facsimile
sender. Otherwise the sender is the user that
invoked _s_e_n_d_f_a_x. The sender is an account
name to which the _H_y_l_a_F_A_X software should
direct notification messages. The _f_r_o_m iden
tity may be a fullblown ``From:'' line, e.g.
e.g. ``Joe Blow <joe@foo.com>'' and
``joe@foo.com (Joe Blow)'' are acceptable. If
no host-part is specified in the _f_r_o_m string
the local hostname is used. This option is
useful when _s_e_n_d_f_a_x is invoked on behalf of
another user, such as in the implementation of
an electronic mail to fax gateway.
--FF _f_o_r_m_a_t Use the specified _f_o_r_m_a_t when imaging tag
lines on outgoing pages. Consult the descrip
tion of the TTaaggLLiinneeFFoorrmmaatt parameter in
_h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MANNUM4_5}) for an explana
tion of how to construct a format string.
_N_o_t_e _t_h_a_t _m_a_n_y _l_o_c_a_l_e_s _r_e_q_u_i_r_e _t_h_a_t _p_r_o_p_e_r
_i_d_e_n_t_i_f_i_c_a_t_i_o_n _a_p_p_e_a_r _o_n _a_l_l _t_r_a_n_s_m_i_t_t_e_d _f_a_c_
_s_i_m_i_l_e_; _w_h_e_n _u_s_i_n_g _t_h_i_s _f_a_c_i_l_i_t_y _o_n_e _s_h_o_u_l_d
_a_l_w_a_y_s _i_n_c_l_u_d_e _p_r_o_p_e_r _i_d_e_n_t_i_f_i_c_a_t_i_o_n _(_e_._g_. _a
_p_h_o_n_e _n_u_m_b_e_r_) _i_n _t_h_e _i_m_a_g_e_d _t_a_g_l_i_n_e_s_.
--hh [_m_o_d_e_m@]_h_o_s_t[_:_p_o_r_t]
Force the jobs to be processed on a specific
_h_o_s_t and, optionally, using a particular
_m_o_d_e_m. The _h_o_s_t may be either a symbolic name
or a network address. If no --hh option is sup
plied, _s_e_n_d_f_a_x uses the FAXSERVER environment
variable to identify the _H_y_l_a_F_A_X server to
which the jobs should be directed. If no
server is specified then _s_e_n_d_f_a_x attempts to
contact a server on the local host. If no
modem is specified, the job will be submitted
to any available modem.
--ii _i_d_e_n_t_i_f_i_e_r
Use the _i_d_e_n_t_i_f_i_e_r string in any notification
messages instead of the usual job identifier
number. This option is useful for applica
tions that cross reference notification mes
sages against job submissions.
--II _t_i_m_e If a job must be requeued because of a commu
nication failure schedule the retry according
to the specified _t_i_m_e. Times are given in
seconds. Minutes, hours, and days can be
specified with ``_m_i_n'', ``_h_o_u_r'', and ``_d_a_y''
suffixes, respectively. By default _H_y_l_a_F_A_X
reschedules jobs using retry times that depend
on the manner in which the job failed; this
interface permits a user to override this
algorithm and specify a single fixed retry
time for all communication failures.
--kk _t_i_m_e Kill the job if it does not complete in the
indicated _t_i_m_e. The _t_i_m_e is specifed using
notation identical to the --aa option. Note
that the _t_i_m_e is relative to the time of the
initial time-to-send. The default kill time
is ``now + 3 hours'' (three hours from the
time the job is first processed). To retry
for an hour, ``now +1 hour'' could be used.
--ll Transmit the facsimile at a vertical resolu
tion of 98 lines/inch; otherwise known as _l_o_w
_r_e_s_o_l_u_t_i_o_n.
--mm Transmit the facsimile at a vertical resolu
tion of 196 lines/inch; otherwise known as
_m_e_d_i_u_m _r_e_s_o_l_u_t_i_o_n or _f_i_n_e _m_o_d_e.
--MM _m_s_t Transmit facsimile documents using the speci
fied minimum scanline time. Possible times
are: 0ms, 5ms, 10ms2, 10ms, 20ms2, 20ms,
40ms2, and 40ms. If the specified time is
less than the transmitting modem or receiver
is capable of, it is increased to the lowest
possible time both devices support. By
default _H_y_l_a_F_A_X will use the lowest possible
time supported by the transmitting modem and
receiving facsimile device (unless restricted
by other server configuration). This option
is mostly useful for debugging.
--nn Suppress the automatic generation of a cover
page for subsequent facsimile. Note that
polling requests do not receive a cover page
unless they are combined with the transmission
of one or more files.
--NN Do not notify the sender by electronic mail
when the facsimile has been delivered or
requeued.
--pp Poll each destination for any available docu
ments. If a poll request is made together
with document transmission, the poll operation
is done after the documents are transmitted.
Documents received by polling are returned to
the sender by electronic mail.
--PP _p_r_i_o_r_i_t_y Assign the specified scheduling _p_r_i_o_r_i_t_y to
subsequent jobs. A priority is an integer
value in the range [0-255]. Lower values
result in higher priority processing. By
default, each job is assigned 127 for an ini
tial scheduling priority. If a job's priority
is greater than bulk faxes then the job's pri
ority is raised (numerically lowered) for each
failed attempt to transmit so that retransmit
attempts are done ahead of newly submitted
jobs. In the case of bulk faxes (numerically
higher than 190), then the job's priority is
lowered (numerically raised) for each failed
attempt to transmit so that the whole of the
bulk-queued jobs will be attempted before any
are retried. The _p_r_i_o_r_i_t_y may also be speci
fied as one of the following symbolic names:
_d_e_f_a_u_l_t or _n_o_r_m_a_l (127), _b_u_l_k or _j_u_n_k (191),
_h_i_g_h (63).
--RR Enable notification by electronic mail when
the facsimile has been delivered and when it
is requeued for retransmission. By default
_H_y_l_a_F_A_X will notify the submitter only if
there is a problem with a job.
--rr _r_e_g_a_r_d_i_n_g
Pass _r_e_g_a_r_d_i_n_g to the _f_a_x_c_o_v_e_r(1) program as
the value of the ``Re:'' field of any gener
ated cover page.
--ss _s_i_z_e Set the page size to use for the transmitted
facsimile. Facsimile are normally imaged with
a system-default page size (usually letter-
size pages, 8.5" by 11", for sites in North
America). Alternate page sizes are specified
symbolically using either the name or abbrevi
ation of an entry in the _p_a_g_e_s_i_z_e_s(${MAN
NUM4_5}) database; e.g. _a_3 (ISO A3), _a_4 (ISO
A4), _a_5 (ISO A5), _a_6 (ISO A6), _b_4 (ISO B4),
_n_a_-_l_e_t (North American Letter), _u_s_-_l_e_g (Ameri
can Legal), _u_s_-_l_e_d (American Ledger), _u_s_-_e_x_e
(American Executive), _j_p_-_l_e_t (Japanese Let
ter), and _j_p_-_l_e_g (Japanese Legal). Compar
isons are case-insensitive and any match of a
substring of the full page-size name is suffi
cient; e.g. ``legal'' would match ``American
Legal''.
Note that it may not be permissible to image
into the full page area; the guaranteed repro
ducible area for a page is typically inset.
Also, note that while arbitrary page sizes can
be specified through the page size database,
only a limited set of page dimensions are sup
ported by the Group 3 facsimile protocol.
Thus if an odd-size facsimile is submitted for
transmission it may not be possible to deter
mine if it can be sent until the fax server
establishes communication with the remote fac
simile machine.
--tt _t_r_i_e_s Make no more than _t_r_i_e_s attempts to send the
facsimile. By default, _H_y_l_a_F_A_X will terminate
a job if: 3 consecutive attempts to send a
particular page fail, or it appears the
receiver is not a facsimile machine. Other
wise _H_y_l_a_F_A_X places no limit on the _n_u_m_b_e_r of
attempts to send a facsimile, instead termi
nating a job if it is not completed within a
_k_i_l_l _t_i_m_e timeout interval. Note that a try
is a call in which carrier is established and
the facsimile protocol is commenced; this is
contrasted with a call attempt that might have
failed because the line was busy.
--TT _m_a_x_d_i_a_l_s Make no more than _m_a_x_d_i_a_l_s calls in attempting
to send the facsimile. By default, HylaFAX
will redial 12 times before killing a job.
--UU _v_o_i_c_e_-_n_o Pass _v_o_i_c_e_-_n_o to the _f_a_x_c_o_v_e_r(1) program as
the sender's voice number.
--VV _v_o_i_c_e_-_n_o Pass _v_o_i_c_e_-_n_o to the _f_a_x_c_o_v_e_r(1) program as
the destination person's voice number.
--ww Wait for the job to complete before ending the
sendfax session. If this option is used, the
sendfax process will not terminate until the
job is completed.
--WW _f_a_x_-_n_o Pass _f_a_x_-_n_o to the _f_a_x_c_o_v_e_r(1) program as the
sender's fax number.
--xx _c_o_m_p_a_n_y Pass _c_o_m_p_a_n_y to the _f_a_x_c_o_v_e_r(1) program as the
destination company name.
--XX _c_o_m_p_a_n_y Pass _c_o_m_p_a_n_y to the _f_a_x_c_o_v_e_r(1) program as the
sender's company name.
--yy _l_o_c_a_t_i_o_n Pass _l_o_c_a_t_i_o_n to the _f_a_x_c_o_v_e_r(1) program as
the destination company's location.
--YY _l_o_c_a_t_i_o_n Pass _l_o_c_a_t_i_o_n to the _f_a_x_c_o_v_e_r(1) program as
the sender's company location.
--vv Print information on the standard output about
each conversion and cover sheet generation
operation it does. If --vv is specified twice,
the protocol between _s_e_n_d_f_a_x and the _h_f_a_x_d
server process that does the submission work
on the remote machine is also displayed.
CCOONNFFIIGGUURRAATTIIOONN PPAARRAAMMEETTEERRSS
_s_e_n_d_f_a_x reads configuration information from the files
$${{LLIIBBDDAATTAA}}//hhffaaxxdd..ccoonnff, $${{LLIIBBDDAATTAA}}//hhyyllaa..ccoonnff, $${{LLIIBB
DDAATTAA}}//sseennddffaaxx..ccoonnff, and ~~//..hhyyllaarrcc; in that order, with
later-read settings superceding any that may have been
previously read. Configuration files follow the conven
tions described in _h_y_l_a_f_a_x_-_c_l_i_e_n_t(1). The following con
figuration parameters are recognized. Parameters marked
with are not available in ${LIBDATA}/hfaxd.conf :
TTaagg TTyyppee DDeeffaauulltt DDeessccrriippttiioonn
AutoCoverPage boolean Yes automatically generate cover page
ChopThreshold float 3.0 page chopping threshold
CoverCmd string _s_e_e _b_e_l_o_w pathname of cover sheet program
Cover-Comments string - cover page comments string
Cover-Company string - cover page to-company name string
Cover-Location string - cover page to-company location string
Cover-Regarding string - cover page regarding string
Cover-Template string - cover page template filename
Cover-Voice string - cover page to-voice number string
Cover-From-Company string -cover page from-company string
Cover-From-Location string -cover page from-location string
Cover-From-Voice string -cover page from-voice number string
Cover-From-Fax string - cover page from-fax number string
DateFormat string - cover page date format string
DesiredEC boolean - desired use of ECM
DesiredMST string - desired minimum scanling time to use
DesiredSpeed integer - desired signalling rate to use
DialRules string _s_e_e _b_e_l_o_w file containing dialstring rules
From string - sender's identity
HRes float 204. horizontal resolution
Host string localhost host to contact for service
KillTime string - time to expire job
MailAddr string - mail address for notification messages
MaxDials integer 12 times to retry dialing
MaxTries integer 3 times to retry transmission
MinSpeed integer - minimum acceptable signalling rate
Modem string - modem to use on server
Notify string none control email notification
PageChop string default control page chop handling
PageLength float - page length in millimeters
PageSize string default page size by name
PageWidth float - page width in millimeters
Port integer 4559 port to use in contacting server
Priority string default job scheduling priority
Protocol string tcp protocol to use in contacting server
RetryTime string - delay between failed attempts to send
SendTime string - time to send job
TagLine string - tagline format string
TypeRules string _s_e_e _b_e_l_o_w file containing file typing rules
VRes float 98. vertical resolution
Verbose boolean No whether or not to enable protocol tracing
The configuration parameters are explained below. Certain
configuration parameters, notably those for setting
strings on automatically generated cover pages, are
defined mainly for use by other _H_y_l_a_F_A_X programs that
share common code used by _s_e_n_d_f_a_x.
AAuuttooCCoovveerrPPaaggee Control whether or not a cover page is
automatically generated for each job.
(Equivalent to the --nn option.)
CChhooppTThhrreesshhoolldd The amount of white space, in inches, that
must be present at the bottom of a page
before _H_y_l_a_F_A_X will attempt to truncate
the page transmission.
CCoovveerrCCmmdd The absolute pathname of the program to
use to generate cover pages. The default
cover sheet program is $${{BBIINN}}//ffaaxxccoovveerr.
CCoovveerr--CCoommmmeennttss The comments string to pass to the cover
sheet program when auto-generating cover
pages.
CCoovveerr--CCoommppaannyy The to-company name string to pass to the
cover sheet program when auto-generating
cover pages.
CCoovveerr--LLooccaattiioonn The to-company location string to pass to
the cover sheet program when auto-generat
ing cover pages.
CCoovveerr--RReeggaarrddiinngg The regarding string to pass to the cover
sheet program when auto-generating cover
pages.
CCoovveerr--TTeemmppllaattee The absolute pathname of a cover sheet
template file to use in auto-generating
cover pages.
CCoovveerr--VVooiiccee The to-voice number string to pass to the
cover sheet program when auto-generating
cover pages.
CCoovveerr--FFrroomm--CCoommppaannyy
The from-company name string to pass to
the cover sheet program when auto-generat
ing cover pages.
CCoovveerr--FFrroomm--LLooccaattiioonn
The from-location string to pass to the
cover sheet program when auto-generating
cover pages.
CCoovveerr--FFrroomm--VVooiiccee
The from-voice number string to pass to
the cover sheet program when auto-generat
ing cover pages.
CCoovveerr--FFrroomm--FFaaxx The from-fax number string to pass to the
cover sheet program when auto-generating
cover pages.
DDaatteeFFoorrmmaatt The _s_t_r_f_t_i_m_e(3) format string to pass to
the cover page command when auto-generat
ing cover pages.
DDeessiirreeddEECC Whether or not to request the use of the
optional Error Correct Mode (ECM) when
transmitting facsimile. (Equivalent to
the --EE option.)
DDeessiirreeddMMSSTT The desired minimum scanline time to use
when transmitting facsimile. (Equivalent
to the --MM option.)
DDeessiirreeddSSppeeeedd The desired signalling rate to the use
when transmitting facsimile. (Equivalent
to the --BB option.)
DDiiaallRRuulleess The name of the file containing the dial
string processing rules to when preparing
an externally visible representation of
the dialstring (e.g. to strip credit card
numbers). By default this is ${LIB
DATA}/dialrules.
FFrroomm The sender's identity. (Equivalent to the
--ff option.)
HHoosstt The host to contact for service. (Equiva
lent to the --hh option.)
HHRReess The horizontal resolution to use when
transmitting facsimile. (NB: _t_h_i_s _c_u_r_
_r_e_n_t_l_y _h_a_s _n_o _e_f_f_e_c_t.)
KKiillllTTiimmee The expiration time to assign to each job.
(Equivalent to the --kk option.)
MMaaiillAAddddrr The electronic mail address to direct
notification messages from the server. If
this string is specified without an
``@hostname'' part then the local hostname
will automatically be appended. (Equiva
lent to the --ff option.)
MMaaxxDDiiaallss The maximum number of times to dial the
phone for each job. (Equivalent to the --TT
option.)
MMaaxxTTrriieess The maximum number of times to retry send
ing a job. (Equivalent to the --tt option.)
MMiinnSSppeeeedd The minimum acceptable signalling rate to
use when transmitting facsimile. (Equiva
lent to the --bb option.)
MMooddeemm The modem to use on the server. (Equiva
lent to the --hh option.)
NNoottiiffyy Control the email notification messages
from the server. This string may be one
of ``done'', ``none'', ``requeued'' or
``default'' with an optionally preceding
``when '' (e.g. ``when done''). Note that
``when requeued'' implies ``when done''.
(Equivalent to the --DD, --RR, and --NN
options.)
PPaaggeeCChhoopp Control page chop handling when transmit
ting facsimile. This string may be one of
``none'', ``all'', or ``last' to have no
pages chopped, all pages chopped, or only
the last page chopped; respectively. Page
chopping is controlled by the CChhooppTThhrreesshh
oolldd parameter.
PPaaggeeLLeennggtthh Set the transmitted page length in mil
limeters.
PPaaggeeSSiizzee Set the page dimensions according to an
entry in the _p_a_g_e_s_i_z_e_s(${MANNUM4_5})
database. (Equivalent to the --ss option.)
PPaaggeeWWiiddtthh Set the transmitted page width in millime
ters.
PPoorrtt The network port to contact for service.
(Eqvuialent to the --hh option.)
PPrriioorriittyy The scheduling priority to assign to each
job. (Equivalent to the --PP option.)
PPrroottooccooll The name of the communication protocol to
use when contacting a server. (Equivalent
to the FFAAXXSSEERRVVIICCEE environment variable.)
RReettrryyTTiimmee The time to delay between job retries due
to a communication failure. (Equivalent
to the --II option.)
SSeennddTTiimmee The time to send jobs. (Equivalent to the
--aa option.)
TTaaggLLiinnee The tagline format string to use when
transmitting facsimile. (Equivalent to
the --FF option.)
TTyyppeeRRuulleess The name of the file containing file type
conversion rules. By default this is
${LIBDATA}/typerules.
VVeerrbboossee Control protocol tracing. (Equivalent to
the --vvvv option.)
VVRReess Set the vertical resolution in lines/inch
to use when transmitting facsimile.
(Equivalent to the --mm and --ll options.)
DDIIAAGGNNOOSSTTIICCSS
The following messages are generated because of problems
encountered on the local machine.
CCoouulldd nnoott ccaallll sseerrvveerr.. The facsimile server on the remote
machine did not respond.
NNoo iinnppuutt ddaattaa;; ttrraannmmiissssiioonn aabboorrtteedd.. No data was supplied
(typically on the standard input). No facsimile will be
sent.
EErrrroorr ccoonnvveerrttiinngg ddaattaa;; ccoommmmaanndd wwaass %%ss.."" A data conver
sion operation failed; the shell command that was used is
printed.
CCaann nnoott ccoonnvveerrtt %%ss.. Data needed to be converted for
transmission, but the required conversion rule was not
located. This may indicate that the _H_y_l_a_F_A_X software was
incorrectly installed; or perhaps that an NFS-mounted
directory is temporarily unavailable.
%%ss:: CCaann nnoott ddeetteerrmmiinnee ffiillee ttyyppee.. _s_e_n_d_f_a_x was unable to
deduce the type of the file.
%%ss:: NNoott aa rreegguullaarr ffiillee.. The file is something other than
a regular file; for example, a directory.
The following messages may be printed by _s_e_n_d_f_a_x. These
messages describe problems encountered by the server pro
cess on the remote machine. This list is incomplete;
other messages may be generated by the server under
unusual circumstances.
FFIILLEESS
~/.hylarc per-user configuration file
${LIBDATA}/hyla.conf system-wide configuration file
${LIBDATA}/sendfax.conf system-wide configuration file
${LIBDATA}/typerules file type and conversion rules
${LIBDATA}/pagesizes page size database
${LIBDATA}/dialrules optional client dialstring rules
${BIN}/faxcover for generating cover sheets
${LIBEXEC}/textfmt for converting text to PostScript
${LIBEXEC}/sgi2fax for converting SGI RGB images
${SPOOL}/tmp/sndfaxXXXXXX temporary files
SSEEEE AALLSSOO
_a_t(1), _h_y_l_a_f_a_x_-_c_l_i_e_n_t(1), _f_a_x_a_l_t_e_r(1), _f_a_x_c_o_v_e_r(1), _f_a_x_
_m_a_i_l(1), _f_a_x_r_m(1), _f_a_x_s_t_a_t(1), _s_g_i_2_f_a_x(1), _t_e_x_t_f_m_t(1),
_h_f_a_x_d(${MANNUM1_8}), _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}), _t_y_p_e_r_
_u_l_e_s(${MANNUM4_5})
January 06, 2001 SENDFAX(1)